<HTML><HEAD><TITLE>plot(++Data, +Options)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">library(gnuplot)</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>plot(++Data, +Options)</H1>
Plots the given data using the given options
<DL>
<DT><EM>Data</EM></DT>
<DD>The data to be plotted, array or list.
</DD>
<DT><EM>Options</EM></DT>
<DD>Options list
</DD>
</DL>
<H2>Description</H2>

<P> Plots the given data to screen using the supplied options.

<P> Can either be a list or a nested list of a 1D or 2D array of y
 values or x-y points.

<P> The options correspond directly to the options of the gnuplot
 'plot' command.

<P> Syntax note: wherever gnuplot expects a string as an option value,
 use a double-quoted ECLiPSe string - unquoted or single-quoted atoms
 will not work!.

<H3>Fail Conditions</H3>
Options are malformed, or data is not in a valid format.
<H3>Resatisfiable</H3>
false
<H2>Examples</H2>
<PRE>
% x-y pairs with 'points'
?- A=[1-3,5-2,9-2,8-2,5-7], plot(A, [with:points]).

% y values with large 'smooth' lines and points
?- A=[1,2,3,4,8,9,4,2,4,6], plot(A, [smooth: csplines,
                                     with:linespoints,
                                     pointsize:3]).

% multiple y values in nested lists with lines, boxes and titles
?- A=[[1,2,4,9,18,27,3],[1,4,16,36,25,16,9]],
   plot(A, [with:[lines, boxes], title:['data 1', 'data 2']]).

% multiple y values in an array, in a certain range, with impulses of
% different widths
?- A=[]([](1,2,4,6,7,8,9),[](1,4,16,36,49,64,81)),
   plot(A, [ranges:(3:6), with:impulses, linewidth:[8,2]]).

% multiple t-r pairs, in polar coordinates with a grid and lines
?- A=[[1-3,5-2,9-2,8-2,5-7], [1-2,5-4,8-6,9-1,12-4]],
   plot(A,[set:[polar, grid=polar], with:lines]).
            </PRE>
<H2>See Also</H2>
<A HREF="../../lib/gnuplot/plot-1.html">plot / 1</A>, <A HREF="../../lib/gnuplot/plot-3.html">plot / 3</A>, <A HREF="../../lib/gnuplot/plot-4.html">plot / 4</A>
</BODY></HTML>
